Adds a given NamedObject to a NameSpace which is addressed through
a second NamedObject. Allows you to link a common group of
NamedObjects together. If the NameSpace doesn't support duplicate
names, then a search for a duplicate will be made, and FALSE returned
if one is found.
INPUTS
nameSpace
The NameSpace to add the NamedObject object to.
If this value is NULL, then the NamedObject will
be added to the root NameSpace. This is useful
for sharing NamedObjects between Tasks.
object
The NamedObject to add to the NameSpace.
RESULT
If the NamedObject can be added to either the supplied NameSpace or
the system global NameSpace, this function will return TRUE.
Otherwise it will return FALSE. This will generally happen when
the NSF_NODUPS flag is set and this NamedObject has the same name
as a second object, or when the object is already in a NameSpace.
NOTES
See BUGS.
EXAMPLE
BUGS
Although the AmigaOS 3.1 autodocs did not say so, under 3.0 you
couldn't add a NamedObject to a NameSpace when the NamedObject you
were adding had a NameSpace itself. This has changed. This is
because the autodocs did not say this, and they are right :)